home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / prog_bas / vuguage.zip / README.TXT < prev    next >
Text File  |  1996-01-07  |  7KB  |  234 lines

  1. ----------------------------------------------------------------
  2.  
  3.                      VUGuage OCX Control  
  4.  
  5.               Copyright 1995 Northeast Data Corp.
  6.  
  7.                      All Rights Reserved
  8.  
  9. ----------------------------------------------------------------
  10.  
  11.  
  12.    Release 1.0
  13.  
  14.    December 1995
  15.  
  16.  
  17. This document describes the VUGuage OLE Custom Control. 
  18.  
  19.  
  20.                CONTENTS
  21.  
  22. 1. Product Description
  23. 2. Legal Information
  24. 3. Installation
  25. 4. Usage
  26. 5. Demonstration Application
  27. 6. Ordering Information
  28. 7. Support
  29. 8. Version release notes
  30.  
  31. ----------------------------------------------------------------
  32.  
  33. 1. Product Description
  34.  
  35. The VUGuage OCX Control is a Microsoft Windows OLE 2.0 custom control
  36. that presents a needle guage control similar to those seen on the 
  37. dashboard of a car.
  38.  
  39. This control is compatible with MS Windows 3.1 through Windows '95. It
  40.  
  41. Being a 16-bit OLE control, the programmer can add the VUGuage Control 
  42. to the tool palette in Visual Basic 4.0 (16-bit), or to any programming
  43. environment that supports 16-bit OCX control (MS Access, for example). 
  44.  
  45. Use of the VUGuage Control in a finished application requires the
  46. VUGuage Control DLL (VUGUAGE.OCX) to be installed with the application.
  47.  
  48. There are properties available that allow the programmer to control
  49. the behavior and appearance of the Control. The VUGuage can appear
  50. in four different orientations. Colors of various parts of the control
  51. can be adjusted, and there are 3D properties that let you specify such
  52. things as borders and bevels.
  53.  
  54. A High and Low limit can be set, which will cause an event to be sent
  55. to your application when either condition occurs.
  56.  
  57. The range of the VUGuage can be set to any range with low and high values
  58. varying from 0 to 32767.
  59.  
  60.  
  61. -------------------------------------------------------------------
  62.  
  63. 2. Legal Information
  64.  
  65. The purchaser of the VUGuage Control is allowed to use it and
  66. distribute it in applications without paying any royalty, and without
  67. printing or displaying a copyright notice for the control. This only
  68. includes distribution of the VUGuage Control DLL (VUGUAGE.OCX). It does 
  69. not include distribution of the VUGuage.lic file, or the documentation 
  70. that comes with the Control. 
  71.  
  72. The purchaser of the VUGuage Control may distribute the control DLL with
  73. applications that are networked (multiple users accessing the DLL from
  74. a file server) without paying any license fees to Northeast Data Corp.
  75.  
  76.  
  77. -------------------------------------------------------------------
  78.  
  79. 3. Installation
  80.  
  81. Note: OCX controls REQUIRE OLE V2.02 or higher. Lower versions will cause
  82. the control registration to fail.
  83.  
  84.  
  85. Create a "VUGUAGE" directory on your hard disk and copy all files from
  86. the distribution disk to the directory. These files include:
  87.  
  88.  
  89.    VUGUAGE.OCX
  90.    VUGUAGE.LIC          (only supplied with registered version)
  91.    README.TXT (this file)
  92.    REGSVR.EXE
  93.    PROJECT1.VBP         (Visual Basic 4.0 16-bit demo program)
  94.    FORM1.FRM   
  95.  
  96. If you have downloaded the ZIP file from Compuserve, use
  97. PKUNZIP to extract the files into the directory.
  98.  
  99. Using the RUN command from the Program Manager, 
  100. Run the REGSVR program to register the control:
  101.  
  102.    REGSVR VUGUAGE.OCX
  103.  
  104.  
  105. From Visual Basic 4.0, open the PROJECT1.VBP file.
  106.  
  107. If you have Microsoft Access V2.0, start it and create a form or report.
  108. From the Edit menu, choose Insert Object, and check the Custom Control
  109. radio button. Choose the VUGuage control to insert it into the form or
  110. report.
  111.  
  112.  
  113.  
  114.  
  115. -------------------------------------------------------------------
  116.  
  117. 4. Usage
  118.  
  119.  
  120. PROPERTIES
  121. ----------
  122.  
  123.    About...    - Displays the about dialog box for the VUGuage control.
  124.  
  125.    BackColor   - Sets the background color.
  126.  
  127.    BorderColor - Color of the border. The border is the region between
  128.                  the outer and inner bevels.
  129.  
  130.    BorderWidth - Width of the border in pixels. 
  131.  
  132.    FaceColor   - Color of the dial area inside the guage.
  133.  
  134.    HighAlarm   - Guage position value that will cause a high alarm event.
  135.  
  136.    HighAlarmColor - Color of the band on the guage that represents high
  137.                     alarm values.
  138.  
  139.    HiliteColor - Color of the top and left sides of the inner and outer
  140.                  bevels if the bevel properties are set to "Raised"
  141.                  or "Solid".
  142.  
  143.                  Color of the bottom and right sides if the bevel
  144.                  properties are set to "Inset".
  145.  
  146.    InnerBevel  - Solid (3), Inset (0), or Raised (2).
  147.  
  148.    InnerBevelWidth - The width of the inner bevel in pixels.
  149.  
  150.    LowAlarm    - Guage position value that will cause a low alarm event.
  151.  
  152.    LowAlarmColor - Color of the band on the guage that represents low
  153.                  alarm values.
  154.  
  155.    Max         - Maximum VUGuage value. This must be greater than the
  156.                  minimum VUGuage value.
  157.  
  158.    Min         - Minimum VUGuage value. This must be less than the maximum
  159.                  VUGuage value.
  160.  
  161.    NeedleColor - Color of the needle.
  162.  
  163.    Orientation - Bottom(0), Left(1), Right(2), Top(3)
  164.  
  165.    OuterBevel  - Solid (2), Inset (0), or Raised (1).
  166.  
  167.    OuterBevelWidth - The width of the outer bevel in pixels.
  168.  
  169.    Pos         - Current VUGuage position. This must be a value between
  170.                  or including the current minimum and maximum values of
  171.                  the VUGuage.
  172.  
  173.    ShadowColor - Black (0), Gray (1).  The color of the left and top
  174.                  sides of the outer and inner bevels when the bevel
  175.                  styles are "Inset". The color of the bottom and right
  176.                  sides when the style is set to "Raised".
  177.  
  178.    TickColor   - Color of tick marks.
  179.  
  180.    TickMarks   - The number of tick marks to display.
  181.  
  182.  
  183.  
  184. EVENTS
  185. ------
  186.  
  187.    Alarm
  188.  
  189.       The Alarm parameter is:
  190.  
  191.          1 - Low alarm 
  192.          2 - High alarm
  193.  
  194.  
  195. -----------------------------------------------------------------------
  196.  
  197. 5. Demonstration Application
  198.  
  199. The VB demo app displays a single VUGuage. The guage range is set 0-100.
  200. A standard scrollbar control is used to adjust the position of the guage
  201. needle. The Alarm event is handled by displaying a messagebox whenever
  202. an alarm occurs. 
  203.  
  204.  
  205.  
  206. -----------------------------------------------------------------------
  207.  
  208. 6. Ordering Information
  209.  
  210. The software can be ordered by filling out the registration information
  211. displayed when the control is first loaded. The registered version of
  212. this software does not display the registration dialog boxes. You may
  213. also register by using the SWREG forum on Compuserve. See the registration
  214. dialog box for the SWREG ID number for this software.
  215.  
  216.  
  217. -----------------------------------------------------------------------
  218.  
  219. 7. Support
  220.  
  221. Technical support is available only for registered users.
  222.  
  223. For technical support, call 716-247-5934 from 8:00 a.m to 5:00 p.m
  224. Monday through Friday. You may also send a FAX to this same number.
  225.  
  226.  
  227. -----------------------------------------------------------------------
  228.  
  229. 8. Version Release Notes
  230.  
  231. Version 1.0  - December 1995
  232.  
  233.    First release.
  234.